package com.feiyisys.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.feiyisys.dto.ActivityAuditDTO;
import com.feiyisys.dto.ActivityRegistrationDTO;
import com.feiyisys.dto.ActivityRegistrationResponseDTO;
import com.feiyisys.entity.ActivityRegistration;
import com.baomidou.mybatisplus.core.metadata.IPage;

/**
 * <p>
 * 活动报名表 服务类
 * </p>
 *
 * @author
 * @since 2025-10-10
 */
public interface ActivityRegistrationService extends IService<ActivityRegistration> {

    /**
     * 用户报名活动
     * @param userId 用户ID
     * @param registrationDTO 报名信息
     * @return 报名响应信息
     */
    ActivityRegistrationResponseDTO registerActivity(Long userId, ActivityRegistrationDTO registrationDTO);

    /**
     * 管理员审核活动报名
     * @param auditDTO 审核信息
     * @return 是否审核成功
     */
    boolean auditActivityRegistration(ActivityAuditDTO auditDTO);

    /**
     * 分页查询待审核报名列表
     * @param current 当前页码
     * @param size 每页大小
     * @return 分页结果
     */
    IPage<ActivityRegistrationResponseDTO> getPendingRegistrations(Long current, Long size);

    /**
     * 根据ID查询报名详情
     * @param id 报名记录ID
     * @return 报名详情
     */
    ActivityRegistrationResponseDTO getRegistrationDetail(Long id);

    /**
     * 生成唯一报名编号
     * @return 报名编号
     */
    String generateRegistrationNo();

    /**
     * 分页查询报名记录，支持按活动及状态过滤
     * @param activityId 活动ID，可为空
     * @param status 审核状态，可为空
     * @param current 当前页码
     * @param size 每页大小
     * @return 分页结果
     */
    IPage<ActivityRegistrationResponseDTO> getRegistrations(Long activityId, Byte status, Long current, Long size);

    IPage<ActivityRegistrationResponseDTO> getRegistrationsByActivityId(Long activityId, Long current, Long size);
}
